byte_array
Functions
Create a byte array from a base-64 string.
Valid base-64 strings may include the characters a-z
, A-Z
, 0-9
, +
and /
as significant characters, and '=' as padding.
Create a byte array from a hexadecimal string.
The given hexadecimal string must have even length, since two hexadecimal characters encode one byte.
Create a byte_array
from a list of integers.
The inverse of byte_array.to_list()
.
All integers in the passed list are treated as single-byte values, i.e. they must be in the range 0 <= x < 256
, and therefore the returned byte_array
will be equal in size to the passed list.
Generate a textual representation of this iterable.
An optional separator, prefix and postfix can be provided. One can also provide a limit: integer?
. If there are more elements in the result than limit
, the elements whose indices exceed limit
are omitted, and the passed truncated: text
is included instead.
Examples:
[1, 2, 3].join_to_text()
returns'1, 2, 3'
.[1, 2, 3].join_to_text('_')
returns'1_2_3'
.[1, 2, 3].join_to_text('*', '(', ')')
returns'(1*2*3)'
.list<T>().join_to_text('!', '(', ')')
returns'()'
(whereT
is a valid type).range(10).join_to_text('', '', '', 5)
returns'01234...'
.range(10).join_to_text('', '', '', 5, 'more')
returns'01234more'
.
Where the function even
is defined:
function even(x: integer): text {
return if (x % 2 == 0) 'EVEN' else 'ODD';
}
Then:
range(10).join_to_text('->', '{', '}', 5, '...', even(*))
returns{EVEN->ODD->EVEN->ODD->EVEN->...}
.
Repeats this byte_array n
times.
Examples:
x'1234abcd'.repeat(3)
returnsx'1234abcd1234abcd1234abcd'
x''.repeat(3)
returnsx''
x'1234abcd'.repeat(0)
returnsx''
Returns a reversed copy of this byte_array
.
Calculates the SHA-256 digest (hash) of this byte array.
Returns a sub-array of this byte array starting from the specified index (inclusive).
Returns a sub-array of this byte array from the specified start index (inclusive) to the specified end index (exclusive).